home *** CD-ROM | disk | FTP | other *** search
/ Languguage OS 2 / Languguage OS II Version 10-94 (Knowledge Media)(1994).ISO / gnu / xinfo101.lha / xinfo-1.01.01 / README < prev    next >
Text File  |  1991-01-09  |  4KB  |  114 lines
  1. This is the latest, and hopefully last, major release of the Info widget
  2. posted on two other occasions to comp.sources.x. I will continute to
  3. provide fixes and small functionality updates as necessary, of course,
  4. but feel that this is now as featureful as it needs to be, given its
  5. intended use.
  6.  
  7. The following changes have been made since the last release:
  8.  
  9. o    Resource entry fixed; no longer coredumps on RISC machines.
  10.  
  11. o    Goto function now more properly implemented.
  12.  
  13. o    Info files may now be compressed to save space - as long as they
  14.     end with a .Z suffix, xinfo will automatically uncompress them for you.
  15.  
  16. o    More bugs fixed; memory no longer leaks like water through a sieve.
  17.     Whoops. Code was also cleaned up a bit more.
  18.  
  19. o    Widget now subclassed from composite, not paned, making it more
  20.     portable to other widget sets. Also handles geometry management
  21.     much more effectively.
  22.  
  23. o    Mouse selections in the text now supported. If something looks
  24.     interesting and you click on it, regardless of where it is,
  25.     something will happen. Maybe even what you wanted.
  26.  
  27. o    Any resource that could be user specified without changing the basic
  28.     functionality of the widget has been put into the resource database.
  29.     Resources in general are now used much more effectively. This doesn't
  30.     mean that you actually need to know how to set them (keine angst, RMS),
  31.     since a reasonable set of defaults are available (and will be
  32.     automatically installed).
  33.  
  34. o    The HELPFILE is gone; the help text is now a resource string. This
  35.     means you can now give your users xinfo help in Pashto or Finnish,
  36.     if you want, simply by editing the database.
  37.  
  38. o    Better support for color. I.E. I thought up some reasonable defaults
  39.     that you can enable if you've got a color system.
  40.  
  41. o    Various accelerators for making life easier have been added.
  42.  
  43. o    A popup dialog for getting required arguments. XInfo no longer just
  44.     beeps at you and gives you a whiny message about what you should have
  45.     done, it jumps up and asks you for it.
  46.  
  47. o    The following text was added (finally):
  48.  
  49. When creating the info widget, the following resources are retrieved from
  50. the resource database:
  51.  
  52. -------------------------------------------------------------------------------
  53. Name        Class        Type        Notes    Default
  54. -------------------------------------------------------------------------------
  55. bellVolume    BellVolume    Int        CSG    50
  56. callback    Callback    XtCallbackList    CSG    NULL
  57. infoFile    InfoFile    String        CSG    XpDefaultInfoFile
  58. infoNode    InfoNode    String        CSG    XpDefaultInfoNode
  59. infoPath    InfoPath    String        CSG    XpDefaultInfoPath
  60. printCommand    PrintCommand    String        CSG    XpDefaultPrintCommand
  61. retainArg    RetainArg    Boolean        CSG    FALSE
  62. -------------------------------------------------------------------------------
  63.  
  64. bellVolume    Determines how loud to ring the bell when something wants
  65.         to complain.
  66.  
  67. callback    If specified, is called when the info widget wants to "quit"
  68.         it is left up to the caller to decide what "quitting" means.
  69.  
  70. infoFile    Which info file to read from. Generally defaults to "dir".
  71.  
  72. infoNode    Which info node to try and find. Generally defaults to "top".
  73.  
  74. infoPath    Colon separated path to follow when looking for info files.
  75.  
  76. printCommand    Which unix command to run when the user asks to print the
  77.         current node. This command will be run on a temporary file
  78.         containing the node's text and header information.
  79.  
  80. retainArg    Determine whether or not to leave text (if any) in the
  81.         argument area around after selecting a node.
  82.  
  83.  
  84. CONTENTS
  85. -------------------------------------------------------
  86.  
  87. This directory contains the sources for an "Emacs Info" browsing widget,
  88. subclassed from the Composite widget.
  89.  
  90. The following files are important:
  91.  
  92. Info.c, Info.h, InfoP.h  - Comprise the Info widget (as is customary)
  93.  
  94. xinfo.c    - A simple application of the info widget (also demonstrates
  95.       usage of the quit callback).
  96.  
  97. XInfo.ad - Application defaults.
  98.  
  99. Compiling should be fairly straigtforward. You may want to edit some
  100. of the defaults in Info.h to match the configuration at your site, though
  101. this really should be changed in the resource database if at all possible.
  102.  
  103. Those wishing for an more elaborate view of the twisty mechanations
  104. of my mind (regarding this code, at least) should read the NOTES file.
  105.  
  106. Questions, suggestions, bug fixes or large anonymous cash donations
  107. (all currencies accepted) should be sent to:
  108.  
  109.                 Jordan Hubbard
  110.  
  111.             ARPA:    jkh@meepmeep.pcs.com
  112.             (OR):    jkh@meepmeep.pcs.de   (europe)
  113.             
  114.